Document GDK_NATIVE_WINDOWS

Add a section in the release notes about it and list it
in the docs with all the other environment variables.

diff --git a/README.in b/README.in
index c92639ba41b69f3f5dd799b5220ffc34b93d88a3..bc2f857aaa61b2153b7f1b99fda5e9de18d4fd6c 100644 (file)
--- a/README.in
+++ b/README.in
@@ -37,6 +37,13 @@ Release notes for 2.18
 * JPEG2000 support is no longer enabled by default. It must be
   explicitly turned on, by passing --with-libjasper to configure.
 
+* GDK has been reworked to implement 'client-side windows'. This offers
+  exciting new possibilities, such as transformed, offscreen rendering,
+  but it breaks some long-standing assumptions that applications may
+  have about GDK windows. Setting the environment variable
+  GDK_NATIVE_WINDOWS makes GDK create a native X11 window for each
+  GDK window, which might make problematic applications work better.
+
 
 Release notes for 2.16
 ======================

diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml
index 4e32c253ed1b6fc7eaf8cc257b840511f61b1b1f..4c3c97fcdc38ee43073f3cac7712c5d0e3832766 100644 (file)
--- a/docs/reference/gtk/running.sgml
+++ b/docs/reference/gtk/running.sgml
@@ -341,6 +341,16 @@ nevertheless.
   </para>
 </formalpara>
 
+<formalpara>
+  <title><envar>GDK_NATIVE_WINDOWS</envar></title>
+
+  <para>
+    If set, GDK creates all windows as native windows. This can help
+    applications that make assumptions about 1-1 correspondence between
+    GDK windows and X11 windows.
+  </para>
+</formalpara>
+
 <formalpara>
   <title><envar>XDG_DATA_HOME</envar>, <envar>XDG_DATA_DIRS</envar></title>